home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -in_the_mag- / reader_requests / scilab / man / man-part1 / cat2 / nyquist.2 < prev    next >
Text File  |  1999-09-16  |  2KB  |  133 lines
  1.  
  2.  
  3.  
  4. nyquist(1)                     Scilab Function                     nyquist(1)
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. NAME
  12.   nyquist - nyquist plot
  13.  
  14. CALLING SEQUENCE
  15.   nyquist( sl,[fmin,fmax] [,step] [,comments] )
  16.   nyquist( sl, frq [,comments] )
  17.   nyquist(frq,db,phi [,comments])
  18.   nyquist(frq, repf  [,comments])
  19.  
  20. PARAMETERS
  21.  
  22.   sl        : syslin list (SIMO linear system in continuous or discrete time
  23.             )
  24.  
  25.   fmin,fmax : real scalars (frequency bounds (in Hz))
  26.  
  27.   step      : real (logarithmic discretization step)
  28.  
  29.   comments  : string vector (captions).
  30.  
  31.   frq       : vector or matrix of frequencies (in Hz) (one row for each out-
  32.             put of sl).
  33.  
  34.   db,phi    : real matrices of modulus (in Db) and phases (in degree) (one
  35.             row for each output of sl).
  36.  
  37.   repf      : matrix of complex numbers. Frequency response (one row for aech
  38.             output of sl)
  39.  
  40. DESCRIPTION
  41.   Nyquist plot i.e Imaginary part versus Real part of the frequency response
  42.   of sl.
  43.  
  44.   sl can be a continuous-time or discrete-time SIMO system (see syslin).  In
  45.   case of multi-output the outputs are plotted with different symbols.
  46.  
  47.  
  48.   The frequencies are given by the bounds fmin,fmax (in Hz) or by a row-
  49.   vector (or a matrix for multi-output) frq.
  50.  
  51.  
  52.   step is the ( logarithmic ) discretization step. (see calfrq for the choice
  53.   of default value).
  54.  
  55.  
  56.   comments  is a vector of character strings (captions).
  57.  
  58.  
  59.   db,phi are the matrices of modulus (in Db) and phases (in degrees). (One
  60.   row for each response).
  61.  
  62.  
  63.   repf  matrix of complex numbers. One row for each response.
  64.  
  65.  
  66.  
  67.   Default values for fmin and fmax are 1.d-3, 1.d+3 if sl is continuous-time
  68.   or 1.d-3, 0.5 if sl is discrete-time.
  69.  
  70.   Automatic discretization of frequencies is made by calfrq.
  71.  
  72. EXAMPLE
  73.   xbasc();
  74.   s=poly(0,'s');
  75.   h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
  76.   comm='(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01)';
  77.   nyquist(h,0.01,100,comm);
  78.   h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
  79.   xbasc();
  80.   nyquist([h1;h],0.01,100,['h1';'h'])
  81.   xbasc();nyquist([h1;h])
  82.  
  83. SEE ALSO
  84.   bode, black, calfrq, freq, repfreq, phasemag
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.